package com.zds.zds_picture_backend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.service.IService;
import com.zds.zds_picture_backend.model.dto.user.UserQueryRequest;
import com.zds.zds_picture_backend.model.entity.User;
import com.zds.zds_picture_backend.model.vo.LoginUserVO;
import com.zds.zds_picture_backend.model.vo.UserVO;
import org.apache.http.client.UserTokenHandler;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * @author 33882
 * &#064;description  针对表【user(用户)】的数据库操作Service
 * &#064;createDate  2025-09-21 19:45:22
 */
public interface UserService extends IService<User> {
    /**
     * 用户注册方法
     *
     * @param userAccount   用户账号，用于唯一标识一个用户
     * @param userPassword  用户密码，需要进行加密处理
     * @param checkPassword 确认密码，用于二次验证用户输入的密码是否正确
     * @return 返回一个长整型值，通常用于表示操作结果：
     */
    long userRegister(String userAccount, String userPassword, String checkPassword);

    /**
     * 用户登录
     *
     * @param userAccount  用户账户
     * @param userPassword 用户密码
     * @return 脱敏后的用户信息
     */
    LoginUserVO userLogin(String userAccount, String userPassword, HttpServletRequest request);

    /**
     * 获得脱敏后的用户登录信息
     * 该方法用于将用户信息进行脱敏处理后返回，确保敏感数据不被泄露
     *
     * @param user 用户对象，包含用户的完整信息
     * @return LoginUserVO 返回脱敏后的用户信息视图对象，仅包含允许展示的非敏感字段
     */
    LoginUserVO getLoginUserVO(User user);

    /**
     * 获取用户脱敏信息
     * <p>
     * 该方法用于从用户实体中提取并返回脱敏后的用户视图对象(UserVO)
     * 脱敏处理通常用于保护用户隐私，隐藏敏感信息如密码、手机号等
     *
     * @param user 用户实体对象，包含完整的用户信息
     * @return UserVO 脱敏后的用户视图对象，只包含前端需要的非敏感信息
     */
    UserVO getUserVO(User user);

    /**
     * 获取用户脱敏信息列表
     */
    List<UserVO> getUserVOList(List<User> user);

    /**
     * 加密用户密码的方法
     *
     * @param userPassword 用户输入的原始密码
     * @return 返回加密后的密码字符串
     */
    String getEncryptPassword(String userPassword);

    public User getLoginUser(HttpServletRequest request);

    /**
     * 注销用户
     * 对应登录态的注销
     */
    public boolean userLogOut(HttpServletRequest request);

    QueryWrapper<User> getQueryWrapper(UserQueryRequest userQueryRequest);

    boolean isAdmin(User user);


}
